Skip to main content

AddProtectedRange

Creates a protected range of the specified type from the selected data range of the current sheet.

Syntax

expression.AddProtectedRange(sTitle, sDataRange);

expression - A variable that represents a ApiWorksheet class.

Parameters

NameRequired/OptionalData typeDefaultDescription
sTitleRequiredstringThe title which will be displayed for the current protected range.
sDataRangeRequiredstringThe selected cell range which will be used to get the data for the protected range.

Returns

ApiProtectedRange | null

Example

This example adds a new name to a range of cells.

var oWorksheet = Api.GetActiveSheet();
oWorksheet.GetRange("A1").SetValue("1");
oWorksheet.GetRange("B1").SetValue("2");
oWorksheet.AddProtectedRange("protectedRange", "Sheet1!$A$1:$B$1");